home *** CD-ROM | disk | FTP | other *** search
/ Dream 55 / Amiga_Dream_55.iso / RISCOS / APPS / TEXT / PS / KIT-PS.ZIP / Kit PS / !PSUtils / man / pstops < prev   
Text File  |  1997-02-12  |  5KB  |  166 lines
  1.  
  2.  
  3.      PSTOPS(1)           Unix Programmer's Manual            PSTOPS(1)
  4.  
  5.  
  6.      NAME
  7.           pstops - shuffle pages in a PostScript file
  8.  
  9.      SYNOPSIS
  10.           pstops [ -q ] [ -b ] [ -wwidth ] [ -hheight ] [ -ppaper ] [
  11.           -dlwidth ] pagespecs [ infile [ outfile ] ]
  12.  
  13.      DESCRIPTION
  14.           Pstops rearranges pages from a PostScript document, creating
  15.           a new PostScript file.  The input PostScript file should
  16.           follow the Adobe Document Structuring Conventions.  Pstops
  17.           can be used to perform a large number of arbitrary re-
  18.           arrangements of Documents, including arranging for printing
  19.           2-up, 4-up, booklets, reversing, selecting front or back
  20.           sides of documents, scaling, etc.
  21.  
  22.           pagespecs follow the syntax:
  23.  
  24.           pagespecs   = [modulo:]specs
  25.  
  26.           specs       = spec[+specs][,specs]
  27.  
  28.           spec        = [-]pageno[L][R][U][@scale][(xoff,yoff)]
  29.  
  30.                  modulo is the number of pages in each block. The
  31.                  value of modulo should be greater than 0; the default
  32.                  value is 1.  specs are the page specifications for
  33.                  the pages in each block. The value of the pageno in
  34.                  each spec should be between 0 (for the first page in
  35.                  the block) and modulo-1 (for the last page in each
  36.                  block) inclusive.  The optional dimensions xoff and
  37.                  yoff shift the page by the specified amount.  xoff
  38.                  and yoff are in PostScript's points, but may be
  39.                  followed by the units cm or in to convert to
  40.                  centimetres or inches, or the flag w or h to specify
  41.                  as a multiple of the width or height.  The optional
  42.                  parameters L, R, and U rotate the page left, right,
  43.                  or upside-down.  The optional scale parameter scales
  44.                  the page by the fraction specified.  If the optional
  45.                  minus sign is specified, the page is relative to the
  46.                  end of the document, instead of the start.
  47.  
  48.                  If page specs are separated by + the pages will be
  49.                  merged into one page; if they are separated by  they
  50.                  will be on separate pages.  If there is only one page
  51.  
  52.  
  53.                      PSUtils Release 1 Patchlevel 16                 1
  54.  
  55.  
  56.  
  57.  
  58.      PSTOPS(1)           Unix Programmer's Manual            PSTOPS(1)
  59.  
  60.  
  61.                  specification, with pageno zero, the pageno may be
  62.                  omitted.
  63.  
  64.                  The shift, rotation, and scaling are performed in
  65.                  that order regardless of which order they appear on
  66.                  the command line.
  67.  
  68.           The -w option gives the width which is used by the w
  69.           dimension specifier, and the -h option gives the height
  70.           which is used by the h dimension specifier. These dimensions
  71.           are also used (after scaling) to set the clipping path for
  72.           each page.  The -p option can be used as an alternative, to
  73.           set the paper size to a3,,, a4,,, a5,,, b5,,, letter,,,     legal,,,
  74.           tabloid,,, statement,,, executive,,, or 10x14... The default paper
  75.           size is a4...
  76.  
  77.           The -b option prevents any bind operators in the PostScript
  78.           prolog from binding. This may be needed in cases where
  79.           complex multi-page re-arrangements are being done.
  80.  
  81.           The -d option draws a line around the border of each page,
  82.           of the specified width.  If the lwidth parameter is omitted,
  83.           a default linewidth of 1 point is assumed. The linewidth is
  84.           relative to the original page dimensions, i.e. it is scaled
  85.           up or down with the rest of the page.
  86.  
  87.           Pstops normally prints the page numbers of the pages re-
  88.           arranged; the -q option suppresses this.
  89.  
  90.      EXAMPLES
  91.           This section contains some sample re-arrangements. To put
  92.           two pages on one sheet (of A4 paper), the pagespec to use
  93.           is:
  94.  
  95.                          2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm)
  96.  
  97.           To select all of the odd pages in reverse order, use:
  98.  
  99.                                         2:-0
  100.  
  101.           To re-arrange pages for printing 2-up booklets, use
  102.  
  103.                         4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm)
  104.  
  105.           for the front sides, and
  106.  
  107.  
  108.                      PSUtils Release 1 Patchlevel 16                 2
  109.  
  110.  
  111.  
  112.  
  113.      PSTOPS(1)           Unix Programmer's Manual            PSTOPS(1)
  114.  
  115.  
  116.                         4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm)
  117.  
  118.           for the reverse sides (or join them with a comma for duplex
  119.           printing).
  120.  
  121.      AUTHOR
  122.           Copyright (C) Angus J. C. Duggan 1991-1995
  123.  
  124.      SEE ALSO
  125.           psbook(1), psselect(1), pstops(1), epsffit(1), psnup(1),
  126.           psresize(1), psmerge(1), fixscribeps(1), getafm(1),
  127.           fixdlsrps(1), fixfmps(1), fixmacps(1), fixpsditps(1),
  128.           fixpspps(1), fixtpps(1), fixwfwps(1), fixwpps(1),
  129.           fixwwps(1), extractres(1), includeres(1)
  130.  
  131.      TRADEMARKS
  132.           PostScript is a trademark of Adobe Systems Incorporated.
  133.  
  134.      BUGS
  135.           Pstops does not accept all DSC comments.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.                      PSUtils Release 1 Patchlevel 16                 3
  164.  
  165.  
  166.